Function: trigger(domElementOrNodeArrayOrCSSSelector, stringEventName)

Description: Manually fires events on specified elements.

Returns: domElement or matching node array, or $A object if chained.

Note: The event naming syntax also supports event namespacing, so that multiple events can be triggered using the same namespace for grouped events.

Example:

// Triggers an event handler on a DOM element.
var myElement = $A.trigger(domElement, "click");

// Trigger multiple events on DOM elements referenced with a CSS selector.
var myElementsArray = $A.trigger("a.tooltip-trigger", "focus mouseover");

// Trigger namespaced events on a DOM element.
var myElement = $A.trigger(domElement, ".myNamespace");

// Trigger namespaced events on an array of DOM elements.
var myElementsArray = $A.trigger([domElement1, domElement2], ".myNamespace");

// Or the same using chaining

// Trigger an event handler on a DOM element.
var myChain = $A(domElement).trigger("click");

// Trigger multiple events on DOM elements referenced with a CSS selector.
var myChain = $A("a.tooltip-trigger").trigger("focus mouseover");

// Trigger namespaced events on a DOM element.
var myChain = $A(domElement).trigger(".myNamespace");

// Trigger namespaced events on an array of DOM elements.
var myChain = $A([domElement1, domElement2]).trigger(".myNamespace");

// To return the modified element within a chain, use the "return()" method.

var myElement = myChain.return();